8. Manual addenda, known conflicts, and other notes
9. How to contact Kensington
WHAT’S NEW:
New Features in version 5.3:
• Support for new devices, "MouseWorks" and "TurboBall"
• Changed how the wheel button is handled* (see below).
• Added a "Scrolling" tab so that the speed of scrolling can be adjusted.
*Note for users of MouseWorks 5.2:
There was a bug in MouseWorks 5.2 that affected mice with scroll wheels, including the Mouse*In*A*Box USB (sold primarily to PC users). The setting for the wheel was being saved incorrectly. This has been fixed in MouseWorks 5.3, but the unfortunate side effect is that if you used MouseWorks 5.2 with a wheel mouse, your old settings are no longer valid and you must reset the wheel button to the desired function for each of your application sets.
Software Requirements:
iMac users must install the iMac Update 1.0 to use this version of MouseWorks. If you have not already installed this update, you can download it for free from www.apple.com.
Scroll Wheel notes:
Scroll wheel support (for Kensington’s Mouse•In•A•Box USB) requires Mac OS 8.5 or higher with USB 1.1 or later installed. It will not work on the original ("Rev. A") iMac unless Mac OS 8.5 and the iMac Update 1.1 are installed. (The latest iMac update, as of this writing, is 1.2, available as a free download from www.apple.com.) After you update your iMac to 8.5 with iMac Update 1.1 or higher, you must re-install Kensington MouseWorks.
USB Notes:
This new USB-savvy software will run on all Macintosh models with built-in USB ports, including iMacs, G3 "blue & white" tower machines, and 1999 or later PowerBook G3 models. It will also work on older PowerMacs with a USB PCI card installed (as long as you have installed the necessary driver software from your card's manufacturer). There is currently no way to use USB devices on older 68K Macs. MouseWorks will still work fine with Kensington ADB devices on non-PowerMacs, but USB devices cannot be used on non-PowerMacs. This is a system software limitation.
Keyboard Notes:
There is currently no USB keyboard support on machines that do not have USB built-in. For those people using a USB PCI card, MouseWorks will not be able to capture keystrokes of a USB keyboard—meaning you can't use a USB keyboard to assign "keystroke" responses to buttons. For all machines with built-in USB (iMacs, blue & white G3s, and 1999 or later PowerBook G3s), the keyboard works fine.
The Easy Install option installs the following files:
Kensington Startup—The Kensington MouseWorks extension that goes in the “Extensions” folder in your “System Folder.”
Kensington Startup ADB—This extension is placed in the “Extensions” folder.
Kensington USB Shim—This extension is placed in the “Extensions” folder and is only used by machines which use USB.
Kensington MIAB Wheel 1,
Kensington MIAB Wheel 2,
Kensginton MIAB Scroll,
Kensington MW Mouse,
Kensington TurboBall—These drivers enable the scroll wheel on various Kensington USB devices, and will only be installed on MacOS 8.5 with USB 1.1 installed. These files are placed in your “Extensions” folder.
Kensington USB Devices—This contains information about USB devices which Kensington supports. This file needed by the software to locate Kensington devices. It is placed in the “Extensions” folder.
ADBReInit—This extension from Apple Computer corrects a problem (possible system freezes when running AppleShare.) on the PowerBook 140/170 and the Quadra 700/900/950. It is only installed if you are running System 7.0.x. This extension is not necessary if you are using System 7.1 or later.
Kensington—This folder is created at the install location. It contains:
- Kensington MouseWorks Read Me—this file.
- Kensington MouseWorks—The program that is used to change mouse options. It is copied into the Kensington folder, and an alias is created in the Control Panels folder.
- SimpleText—A program from Apple Computer that is used to view simple documents including this Readme document. If you don’t have TeachText or SimpleText already installed on your machine, we install a copy.
- Application Sets folder—Contains the sample application sets.
- Internet Config 1.4—Contains the Internet Config application and its documentation. This only gets installed if you don't already have Internet Config.
Internet Config Extension—This will get installed in the “Extensions” folder in your “System Folder.” This is needed to open Internet websites.
WHAT GOES WHERE—COMPLETE INSTALL:
The Complete Install option installs everything in the Easy Install plus the following:
Kensington—This folder will contain the following additional files:
- Utilities—A folder containing the following infrequently used items:
- Convert Preferences—A program that converts Turbo Mouse 4.0x preference files into 5.x compatible Kensington MouseWorks preference files.
- Custom Response—A description of the Custom Response string format in SimpleText format.
- Compatibility Options—A description of the Compatibility Options in Simple Text format.
- Acceleration- A description of the Acceleration Table in Simple Text format.
- Kensington ADB Test—A test program that can be used by Kensington’s technical support department to find out information about your Macintosh.
- ADBReInit Note—Instructions on the use of ADBReInit extension from Apple.
INSTRUCTIONS FOR UPGRADING FROM PRIOR VERSIONS:
You should remove any old copies of Turbo Mouse Startup, Thinking Mouse Startup, or Kensington Mouse Startup prior to installing MouseWorks 5.2. (The Kensington MouseWorks Installer will automatically look for any of these files in your Extensions folder and ask you if you want to remove them.)
Users of the Turbo Mouse 4.0x software can use the Convert Preferences program located in the Kensington Utilities folder to convert their old Turbo Mouse Preferences file to a new Kensington Preferences file used in this version of software. You must do a Complete Install in order for this utility to be installed.
When updating from a previous version of Kensington MouseWorks the “Kensington Startup” extension may not have the correct icon displayed inside the Extensions folder. This is purely cosmetic. It does not affect the functionality at all. To fix this simply rebuild the desktop (hold down option-command while the Finder is restarting).
PC COMPATIBILITY PRODUCTS:
MouseWorks provides users of Apple’s PC Compatible products with seamless support for two button pointing devices in the PC Environment. If you use Apple’s PC Setup 1.5 or higher, MouseWorks will detect that a PC Compatible Card is installed, and configure itself to behave correctly in the PC environment. MouseWorks will create an application set for the PC environment that, by default, contains the following settings.
• The right buttons on multi-button devices are set to send the Right Click signal when you are in the PC environment. You can use the MouseWorks control panel, (the “More Clicks” feature) to modify these types of clicks.
• Acceleration is set to zero. This lets you adjust mouse speed in the PC environment without having problems associated with two acceleration multipliers being engaged. (i.e., You only have one volume knob to adjust.)
• The chord speed is set very fast. This provides better button response in the PC environment.
• All other settings are “inherited” from the current default application set.
Limitations in the PC Environment—MouseWorks is optimized to give basic mouse performance when using the mouse in the PC environment. Some of the advanced features of MouseWorks that are available in the MacOS environment will not work well, or will not work at all in the PC environment.
Features that work well: Click; Drag; Slow Cursor; Axis-only.
Features that may work in the PC environment: Shortcuts may work: this is heavily dependent on the specific shortcut, and which command it implements; Keystrokes: short Keystrokes responses will work OK. (For example Command+Return to toggle environments works well.) Longer keystrokes may give unexpected results.)
Features that do not work in the PC environment: Brilliant Cursor; Pop-Up menus; Snap To Default; Double-Click (the programmed response. Normal double-clicking works without problems).
If You Use An Earlier Version Of PC Setup: We recommend that you upgrade to version 1.5. In the mean time, you can still use MouseWorks for two button support in the PC environment. See below.
If you use SoftWindows, Virtual PC, or any other PC Compatible product, you will find a couple of application sets in the Application Sets folder which you can use for your PC compatible environments. To import one of these sets follow the instructions in the manual to import an application set. Use either the SoftWindows set, or the PC Mode set.
INTERNET CONFIG
Internet Config is a program which performs various services used by most Internet-savvy programs. Kensington MouseWorks uses Internet Config to open web sites on the Internet.
Internet Config is installed as part of the Kensington MouseWorks installation, unless you already have it on your machine.
If you want to further configure your internet settings (for e-mail, ftp, newsgroups, etc.) launch the “Internet Config” program located inside of the “Internet Config 1.4” folder in your main “Kensington” folder.
MAC OS 8 Issues:
STICKY MENUS—There is a feature in MacOS 8 called “Sticky Menus” which is used for locking down menus. You activate sticky menus by quickly clicking (press and release) on the menu bar. When the system sees this quick click and release it will keep the menu down. If you have our Menu Lock feature turned on and you quickly click and release on the menu bar two times in a row you have to send an extra click through to release the menu. This is because both Menu Lock and Sticky Menus were activated in succession.
This problem only shows up when you click quickly TWO times in a row. Single clicks cause no problem since Menu Lock takes care of locking the menu at this point and Sticky Menus never gets turned on.
Microsoft Office 98 Issues:
INSTANT MENU—MouseWorks’ “Instant Menu” feature allows you to click anywhere on the screen and have a “pop-up menu” appear which contains the same menus as are shown in the menubar. However, the design of Office 98 applications (Word, Excel, and PowerPoint) does not permit this feature to function properly. Therefore, Instant Menu has been disabled in those applications.
MANUAL ADDENDA, KNOWN CONFLICTS, AND OTHER NOTES:
STARTUP PROBLEMS—If you are having problems be sure you are using the latest versions of any extensions or control panels you may have in your System Folder. Also, we have seen a few instances where corrupted fonts can prevent certain extensions (including ours) from loading. Reinstalling good copies of the fonts fixes this problem.
BRILLIANT CURSOR—When HotSpots are very, very close together, it may be harder to accurately point to the nearest HotSpot.
AFTER DARK ONLINE—Users of After Dark Online or other After Dark interactive modules will find that they cannot use Kensington input devices to click on objects in After Dark interactive screen savers. This is due to a problem with the way that the After Dark engine looks for mouse clicks. Berkeley Systems <http://www.berksys.com> tells us that the problem will be fixed in a future version of the After Dark engine.
ADVANCED GRAVIS MOUSESTICK II and/or FIREBIRD—
1. Kensington MouseWorks software now ignores Advanced Gravis <http://www.gravis.com> devices (with ID 23 and 4E) by default. This means that Kensington acceleration controls will not, by default, have any effect on Gravis devices. This results in better performance of the Gravis devices, and will eliminate locks up and other problems related to the Kensington software attempting to manage input from the Gravis devices.
2. Users of both Kensington and Gravis devices may experience problems (lockups, device acceleration problems, and application crashes) when both devices are connected and software from both companies is loaded. In our testing, these problems are eliminated by forcing the Gravis software to load first. Since extensions load in alphabetical order, the Firebird software and Kensington Startup software will not normally have a problem (unless you have taken steps to change the load order.) However, since Control Panels load after extensions, you ARE likely to have problems with the MouseStick II Control Panel. (Latest tested version 3.3.1.) You may be able to solve this problem by using an extension manager, or by moving the Kensington Startup extension OUT of the extensions folder and into the system folder. This will force the Kensington Startup extension to load last. If you experience any problems using your Kensington device this way, put the Kensington Startup extension back into the extensions folder.
EUDORA—You should not attempt to define HotSpots while Eudora is the frontmost application. Trying to bring up the Brilliant Cursor Hotspot definition window while Eudora is frontmost will in all likelihood crash Eudora.
ADOBE ILLUSTRATOR—Versions earlier than 5.01 do not work with the Brilliant Cursor HotSpot Definition window.
ISI MOUSESCREEN ADB—ISI touch screen users cannot use Kensington mouse startup because the ISI device does not correctly follow the ADB specification. Use Kensington Basics or the serial version of the Mousescreen to work around this problem.
MICROSOFT EXCEL—The scrolling features do not work in Microsoft Excel 5.0.
QUICK TOOLS POWER STRIP—Interferes with Brilliant Cursor HotSpot definition. You must temporally disable this product before defining HotSpots.
CHANGING MOUSE BUTTONS ON NON-KENSINGTON INPUT DEVICES—The mouse buttons on non-Kensington input devices are, by factory settings, not modified by MouseWorks. They always send a normal button (Click) and do not work with the Menu Lock feature. With most ADB devices, however, you can change this if you wish. (Note: MouseWorks does not allow you to change the button settings for non-Kensington USB input devices.)
Caution: If you make this change (as described below), the single button on the non-Kensington mouse is treated the same as the Left Button on the Kensington Mouse. This can cause confusion if you have changed the Left Button to something other than a Click. The non-Kensington input device’s button will also be changed. Then, if you disconnect the Kensington Mouse, you may not be able to control the Macintosh. If you find yourself in this state, you can recover in one of two ways:
- Restart your Macintosh with the “T” key pressed down, this causes the Kensington mouse software not to load during startup. You can then delete your preference file and restart.
- Shutdown your Macintosh, plug your Kensington Mouse back in and restart your Macintosh.
If you want to be able to use change the mouse buttons on a non-Kensington device:
1. Determine the type of device by opening the About... window in the Kensington MouseWorks. You will see a list of connected devices.
2. Open the Compatibility Options window. To do this, hold down the Option key on the keyboard, and while holding this key down, choose Compatibility Options from the Options menu.
3. Double-click on the device you identified in the About... window.
4. Deselect the “Do Not Use Enhanced Mouse Buttons” checkbox.
5. Click the OK buttons to close each of the windows you opened.
6. Choose Save Startup from the File menu.
7. Restart your Macintosh.
The first button on the non-Kensington input device will now be treated the same as the Left Button. All button features will now work. If the device has a second button, it may work as a right button. (This depends on the how the manufacturer designed the device.) To avoid the problem described above, either:
- Do not redefine the Left Button press, or if you do redefine it, define it with a Button Response capable of doing a normal click, such as a Pop-Up Menu with a Button item, or a Drag.
- Before disconnecting the Kensington Mouse, change the Left Button to Click.
- Go back into the Compatibility dialog and select the “Do Not Use Enhanced Mouse Buttons” option for the input device you are using.
The Kensington Utilities folder (installed to the Kensington folder during a Complete Installation) contains additional information on the Compatibility options in a file called “Compatibility.” PowerBook Duo users with two buttons may want to read about the Swap Buttons option that can be used to swap the meaning of the top and bottom buttons of the Duo’s built-in trackball.
CONTROL PANEL HIDDEN FEATURES—There are a few obscure features within Kensington MouseWorks that can only be accessed when the option key is held down. They are:
• CUSTOM RESPONSE—Hold down the Option key while clicking on the response menu in the Buttons tab, to show the Custom response item. The syntax for this response is defined in the Custom Response document installed on your system during a COMPLETE Kensington MouseWorks installation.
• COMPATIBILITY OPTIONS—Hold down the Option key while clicking on the Options menu to show the Compatibility Options item. Compatibility Options is documented in the Compatibility Options document installed on your system during a COMPLETE Kensington MouseWorks installation.
• ACCELERATION TABLE—Hold down the Option key while viewing the Acceleration tab (with the Fine Adjustment checkbox selected) to display the Table button. The dialog that comes up in response to this button allows for very fine tweaking of the acceleration curve. The Acceleration Table is documented in the Acceleration document installed on your system during a COMPLETE Kensington MouseWorks installation.
• CONVERT SHORTCUTS—In the Shortcut dialog (displayed when a shortcut response is selected from the Response Menu) the OK button is changed to a Convert button when you hold down the Option key. Clicking Convert will convert the selected shortcut action into its custom parts: it will be displayed as such from then on (i.e. the Cancel shortcut will be displayed as a keystrokes response that sends an Escape character. Note that the label for the response maintains the Shortcut name).
